home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / bmouse10.zip / BATMOUSE.DOC next >
Text File  |  1992-06-09  |  7KB  |  170 lines
  1. BATMOUSE Version 1.0 Copyright (c) 1992 by Stephen T. Batson Jr.
  2.  
  3. Introduction
  4. ---------------
  5.  
  6. BATMOUSE is a utility designed to allow users to write DOS Batch
  7. files with mouse support. I came up with this idea one day while
  8. I was writing my own mouse library functions in C. I thought, why
  9. not? I use batch files for alot of various purposes simply
  10. because they get the job done and require much less time to
  11. write than other languages. Batch files used with small enhancement 
  12. programs like BATMOUSE can make batch files extremely powerful. 
  13. I have not seen any programs which allow a mouse to be used from Batch
  14. files,  but I won't claim to be the first since some programmer
  15. out there has probably had the same idea. In anycase, I hope you
  16. enjoy BATMOUSE, it is simple to use and I have included an
  17. example batch file and ansi screen to show how simple it is to
  18. use. I have tested BATMOUSE with MicroSoft and Logitech Mouse Drivers 
  19. with no problems. BATMOUSE should work with most mice. Enjoy!
  20.  
  21. Disclaimer
  22. -------------
  23.  
  24. By using this program you agree to all the terms of this
  25. disclaimer. The user of this program uses it at their own risk.
  26. There are no warranties of any kind written nor implied. The Author
  27. and distributors of this program will not be responsible for any
  28. loss or damages of any kind as a result of using this program.
  29. No warranties as to suitability of this program to a specific
  30. purpose are made.
  31.  
  32. Shareware
  33. --------------
  34.  
  35. BATMOUSE is not public domain or freeware. You may try BATMOUSE
  36. for up to 30 days at no cost. After that period you are required
  37. register the program or discontinue its use. I do not believe in
  38. "Nagware" where a program begs for money everytime you load it
  39. nor have I limited the features of this program. As of this
  40. writing, This is a fully functional program. I may make
  41. enhancements to it at anytime though and do not guarantee that I
  42. will upload all future versions to any system to replace this
  43. one (unless I find bugs of course). I won't go on preaching
  44. about shareware, you have probably read enough on the topic from
  45. other downloads. All I will say is this. If you register, I will
  46. send you the most current copy of this program along with other
  47. handy batch file and dos utilities that I have developed. Fair
  48. enough? Good. Please share this package in its entirety with
  49. your friends and co-workers. BBS operators may post it on their
  50. systems. This program may not be distributed with any other
  51. product be it hardware or software without express written
  52. permission from Batson Enterprises. Shareware distributors must
  53. contact Batson Enterprises for permission and instructions on
  54. how to distribute this program. 
  55.  
  56. Included files
  57. -----------------
  58.  
  59. You should have the following files:
  60.  
  61. BATMOUSE.EXE
  62. BATMOUSE.DOC
  63. README.NOW
  64. DEMO.BAT
  65. DEMO.ANS
  66.  
  67.  
  68. If you don't have all these files, you may contact me at the
  69. address found in the registration section. Send a Self Addressed
  70. Stamped Disk Mailer and a blank formatted disk  
  71.  
  72. (360k or 1.2meg  5 1/4"or 720k or 1.44k  3 1/2" )and I will send
  73. you the full set of files.
  74.  
  75.  
  76. Program Usage
  77. -------------------
  78.  
  79. Simple! When you run BATMOUSE from DOS prompt, you will be given
  80. a mouse cursor on the screen. When you click the left button on
  81. the mouse, 2 files will be written to the current drive and
  82. directory. These files are MCOORDX.nnn and MCOORDY.nnn. 
  83.  
  84. Where nnn = the X or Y coordinate for the DOS Text Screen
  85. location.
  86.  
  87.       MCOORDX.nnn = the X coordinate, nnn is a number from 1-80.
  88.       MCOORDY.nnn = the Y coordinate ,nnn is a number from 1-25.
  89.  
  90. A position of X=10 and Y=20 would place the cursor on the 20th
  91. row starting at the 10th column. In this case, you would get
  92. back the following:
  93.  
  94.  
  95.      MCOORDX.10
  96.      MCOORDY.20
  97.  
  98. Your batch file can check for these files with the EXIST
  99. statement and execute the appropriate
  100.  
  101. portion of the batch file. I wont attempt to teach you batch
  102. files here, so see your DOS manual and the DEMO.BAT file
  103. included however, an example might look like this:
  104.  
  105. :loop
  106. if exist mcoordx.10 goto exit
  107. goto loop
  108. :exit
  109. if exist mccordy.20 goto end
  110. goto loop
  111. :end
  112.  
  113. This little example would loop until the mouse was CLICKED on
  114. the X=10 and Y=20 screen location. For those somewhat familiar
  115. with DOS and Mouse cursor coordinates, the Mouse location in the
  116. 80 column mode is equal to 8 for every character position you
  117. increase on the X or Y coordinates. For example, X=1 is really 0
  118. to the mouse, X=2 is 8 to the mouse, X=3 is 16 to the mouse and
  119. so on. You need not worry about this, since the mouse cursor
  120. screen location translated for you to DOS screen coordinates.
  121.  
  122.  Also, This program is designed to work in the 80 column mode in
  123. DOS. You may be able to get some functionality in other modes,
  124. but no technical support at this time will be provided in other
  125. modes. The DEMO.BAT file is provided as an example, you may have
  126. a better way to write your batch file. Have fun, experiment. The
  127. program will clean up the MCOORDY.nnn and MCOORDX.nnn files each
  128. time it is run, it deletes any of these files before it sets up
  129. the mouse so you will only see the 2 files at 0 bytes on your
  130. disk at anyone time.
  131.  
  132. -----------------------------------------------------------------------------
  133.  
  134.                      BATMOUSE REGISTRATION ORDER FORM
  135.  
  136.  
  137.  
  138. NAME:____________________________________________________________
  139.  
  140. ADDRESS:_________________________________________________________
  141.  
  142. CITY:______________________________ STATE:__________ZIP__________
  143.  
  144. TELEPHONE: ________________________________________
  145.  
  146.  
  147. Please register me for the ______copie(s) of BATMOUSE and send
  148. me the most recent version along with your DOS and Batch File
  149. Enhancement utilities. I am including a check or money order for
  150. $10.00 Plus $3.00 Shipping and Handling for each copy.
  151.  
  152. Allow time for checks to clear, orders including money orders
  153. will be shipped within 2 to 5  working days.
  154.  
  155. Send To: Batson Enterprises
  156.          4521 Fenwick Way
  157.          North Highlands, CA 95660
  158.  
  159. Comments and Suggestions:
  160.  
  161. _________________________________________________________________
  162.  
  163. _________________________________________________________________
  164.  
  165. _________________________________________________________________
  166.  
  167. _________________________________________________________________
  168.  
  169. _________________________________________________________________
  170.